home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / grab3a.arc / GRAB.DOC next >
Text File  |  1987-12-08  |  19KB  |  404 lines

  1.  
  2.  
  3.  
  4.            GRAB The Envelope Address Printer - Copyright 1987 By Paul Mayer
  5.  
  6.            Have you ever wanted to have your favorite word processor take
  7.            the name and address from a letter and print your envelope?
  8.  
  9.            Well now it is possible with GRAB!  GRAB is a memory resident
  10.            program that will allow you to point at the address in your let-
  11.            ter, GRAB IT, and then print your envelope for you.
  12.  
  13.            There are three files that comprise the GRAB system:
  14.  
  15.            GRAB.EXE    -  The memory resident program.
  16.            GRABCFG.EXE -  The GRAB configuration utility.
  17.            GRAB.DOC    -  This file.
  18.  
  19.            The GRAB program was first created in the fall of 1986 written in
  20.            Turbo Pascal.  After being out for a little over a year on the
  21.            'shareware' circuit GRAB has now been rewritten as a new system.
  22.            This latest release has been redone under Turbo Pascal 4.0 and is
  23.            the result of many enhancement suggestions from the users of the
  24.            earlier versions.  One of the most important improvements is the
  25.            ability to use GRAB from the DOS prompt.
  26.  
  27.            CONFIGURE GRAB
  28.  
  29.            By using the GRABCFG program you can change many of the GRAB
  30.            default settings.  GRABCFG.EXE should be in the same directory as
  31.            your GRAB.EXE program when you do this.  The main menu of the
  32.            configuration program has seven selections and they are as fol-
  33.            lows:
  34.  
  35.            1 - 'Hot Key'  This will open a sub-menu which will allow you to
  36.            change the GRAB 'Hot Keys'.
  37.  
  38.                 a - The 'Main Hot Key' that calls GRAB from memory into use.
  39.                 This can be now set to multiple key combinations to
  40.                 eliminate the accidental calling of GRAB.  You could for ex-
  41.                 ample set a combination such as <Ctrl><Right Shift> and Z as
  42.                 your key combination.
  43.  
  44.            The following keys may only be set with simple <Alt> or <Ctrl>
  45.            and <Key> combinations.
  46.  
  47.                 b - The 'Print Marker Key' which tells GRAB to print the ad-
  48.                 dress after you cover it with the 'marking block'.
  49.  
  50.                 c - The 'Print Window Key' which calls up a manual entry
  51.                 window so you can type in the name and address by hand.
  52.  
  53.                 d - The 'Toggle Print Return Key' which will toggle the
  54.                 printing of the return address on and off.
  55.  
  56.                 e - The 'Toggle Small Envelope Key' which will toggle the
  57.                 size from regular to small envelopes.
  58.  
  59.  
  60.  
  61.  
  62.            2 - 'Printer'  This selection will give you a sub-menu that re-
  63.            quests information about your printer set up.
  64.  
  65.                 a - 'Type of Printer'  This will ask you to select from one
  66.                 of the two HP Laserjet type printers (to take advantage of
  67.                 their envelope feed facility) or from a regular printer.
  68.  
  69.                 b - 'Check Printer' This selection is to tell GRAB to check
  70.                 your printer before printing the envelopes.  This eliminates
  71.                 the DOS ERROR message 'Abort, Retry, Ignore'. If your par-
  72.                 ticular application hangs up when GRAB performs this check,
  73.                 you may tell GRAB to not check the printer first and allow
  74.                 DOS to do the checking.
  75.  
  76.                 c - 'Init/Exit Printer'  GRAB also can send an initializa-
  77.                 tion string to the printer as well as an exit string.  The
  78.                 use for this would be if you have a dot matrix printer that
  79.                 requires a special code to turn the 'letter quality mode' on
  80.                 and another code to return the printer to it's normal state.
  81.                 You would enter the decimal codes from your printer manual
  82.                 in the configuration program.  An example of this would be
  83.                 to set the Epson FX286 to 'letter quality mode'.
  84.  
  85.                 Enter in the first block available for the Init string the
  86.                 decimal code for escape which is 27 then in the second block
  87.                 available enter the decimal code for G which is 71.  These
  88.                 two codes will send an escape G to the printer before print-
  89.                 ing your envelope.  The exit string would be entered in the
  90.                 Exit string blocks using the codes for escape H (or 27 72)
  91.                 in the first two blocks available.  You have a string of up
  92.                 to eight blocks for both the Init string and the Exit
  93.                 string.
  94.  
  95.  
  96.                 The Init string can be made to print at the beginning of
  97.                 each line also in the configuration.
  98.  
  99.            3 - 'Return Address' This will give you a sub-menu that will al-
  100.            low you to tell GRAB that by default you want to print your
  101.            return address and also enter it.
  102.  
  103.                 a - 'Print Return Address?'  This entry will allow you to
  104.                 set the default to print your return address.  You may
  105.                 toggle your default answer here while you are in the GRAB
  106.                 program.
  107.  
  108.                 b - 'Return Address'  If you want to use a return address
  109.                 this is the selection that you use to enter the information
  110.                 into your configuration file.
  111.  
  112.  
  113.  
  114.  
  115.            4 - 'Envelopes'  This selection will allow you to use different
  116.            size envelopes.  GRAB comes configured for the standard business
  117.            size envelope which is 4 x 9 1/2 in size.  This is where you can
  118.            change GRAB to print on the smaller 3 5/8 x 6 1/2 size.
  119.  
  120.                 a - 'Small Envelopes'  With this selection you can set the
  121.                 default to print the small size envelopes.  This default as
  122.                 the 'return address' default may also be toggled from
  123.                 regular to small.
  124.  
  125.            5 - 'Locations'  If you do not like the default print locations
  126.            for the two different envelopes you can adjust them.  This is the
  127.            selection that you would use if you did not want to use the
  128.            default address printing locations.
  129.  
  130.                 a - 'Change Locations'  Here you can change the 'Up down
  131.                 location of the TO ADDRESS', the 'Left right location of the
  132.                 TO ADDRESS' and the 'Left right location of the FROM
  133.                 ADDRESS'.  To decrease the number of spaces or lines in a
  134.                 print position you would enter a negative number. Let us say
  135.                 for five less spaces or lines we enter a '-5'.  To increase
  136.                 the spaces or lines we would enter a positive number.
  137.  
  138.            6 - 'Color'  You can change the colors of the text marking block.
  139.  
  140.                 a - 'Change Colors'  Here you will be given a screen that
  141.                 looks like a WordStar editing screen with GRAB called up.
  142.                 You can use the left/right and up/down arrow keys to change
  143.                 the default colors.
  144.  
  145.            7 - 'Exit'  This last selection allows us to read from and write
  146.            to a configuration file or exit the configuration program.
  147.  
  148.                 a - 'Get'  Will read in the existing GRAB.CFG file if it is
  149.                 there.  This allows you to modify the changes you made the
  150.                 last time you used the configuration program.  If you do not
  151.                 get a file the default setting will be those that GRAB
  152.                 originally came with.
  153.  
  154.                 b - 'Save'  Will write your configuration to the GRAB.CFG
  155.                 file.  This is the selection that you take after setting all
  156.                 of your preferences.
  157.  
  158.                 c - 'Exit'  This will exit the program and return you to
  159.                 DOS.
  160.  
  161.  
  162.            USING GRAB
  163.  
  164.            1 - 'Installation'  To install GRAB for use just type GRAB at the
  165.            DOS prompt.  GRAB will install itself into memory awaiting the
  166.            'Hot Key' to call it up for use.  GRAB has been written to co-
  167.            exist with other memory resident applications.  Borland
  168.            International's SideKick is one memory resident program that re-
  169.  
  170.  
  171.  
  172.            quests that it be loaded after all other utilities.  For this
  173.            reason, GRAB will not load itself if you have SideKick loaded
  174.            prior to your attempt to load GRAB.
  175.  
  176.            When GRAB has successfully loaded you will receive a conformation
  177.            notice.  In the notice you will be shown the 'Hot Key' combina-
  178.            tions as installed.
  179.  
  180.            If you do not use SideKick, you can have GRAB install itself
  181.            along with your word processor and then remove itself from memory
  182.            upon exiting your word processor.  You would use a batch file
  183.            like shown below as this will install GRAB then load your word
  184.            processor and after your finished it will remove GRAB from
  185.            memory.
  186.  
  187.            The following example batch file would load GRAB then load
  188.            WordStar 4.  After you exit from WordStar it would remove GRAB
  189.            from memory.  You should name the batch file WS4.BAT presuming
  190.            your WordStar 4 is called WS.EXE the following is presented:
  191.  
  192.            GRAB
  193.            WS
  194.            GRAB /R
  195.  
  196.            That's right!  Only a three line batch file.
  197.  
  198.  
  199.            2 - 'Calling GRAB From Memory'  To invoke GRAB just enter into
  200.            your favorite word processor and when you have your letter on the
  201.            screen with the address showing, just hit the assigned 'Hot Key'
  202.            combination.  If you screen is in the 'Graphics mode' GRAB should
  203.            not load itself.  In this case GRAB should just respond with a
  204.            beep when you attempt to call it.
  205.  
  206.            After you invoke the system, GRAB will display an instruction
  207.            window on some of the commands.  Also the toggles for the return
  208.            address and small envelopes will be displayed.  GRAB will then
  209.            mark the screen with the area that will be printed on the en-
  210.            velope.  You can move this area around with the arrow keys on the
  211.            keypad to cover the address that you want to print.  The size of
  212.            this marker can be slightly altered.  The default size is 5 lines
  213.            of 40 characters across.  You can change the width of the marker
  214.            with the F7, smaller and F8, wider keys, the height with the F9
  215.            and F10 keys.  F9 will shorten the height down to 3 lines and F10
  216.            will increase the height to a maximum of 7 lines.  After you have
  217.            the address covered, just tap the 'Print Marker Hot Key' to print
  218.            the address.  If you are using a standard printer you should have
  219.            positioned your envelope so the print head will cross on the
  220.            first line that you would like the address to appear.  The ad-
  221.            dress will print forty spaces over from the left margin.  If you
  222.            have the HP laserJet printer you will just insert your envelope
  223.            in the standard envelope feed position.  If you want to abort the
  224.            print process just hit the ESC (escape) key instead of the 'Print
  225.            Marker Hot Key' combination.
  226.  
  227.  
  228.  
  229.  
  230.            GRAB will strip control codes from the address before printing.
  231.            GRAB will only accept ascii characters and will strip and replace
  232.            the non-ascii characters with a nul.  Also some word processors
  233.            use an ascii display for control codes, GRAB detects the ^ con-
  234.            trol code followed by a letter and strips this out as well as the
  235.            < and > markers that are sometimes used to mark a carriage
  236.            return.
  237.  
  238.            You can also type the address in to GRAB by hand if desired by
  239.            hitting 'Print Window Hot Key' when in GRAB and a window will
  240.            open and request the address.  This is useful to address an en-
  241.            velope that you need to send a "carbon copy" of a letter to.
  242.            After typing in the address the PgDn key will print the envelope
  243.            for you.  This can also be used from DOS or any other program
  244.            that you might be in.
  245.  
  246.            3 - 'Remove GRAB from Memory'  To remove GRAB from memory just
  247.            type GRAB /R or GRAB -R at the DOS prompt.  Then GRAB will remove
  248.            itself from memory.
  249.  
  250.            Do not remove GRAB if you have other memory resident programs
  251.            loaded after GRAB, this could cause unexpected results.
  252.  
  253.            EDIT COMMANDS
  254.  
  255.            Edit commands available for use in the data entry areas are as
  256.            follows:
  257.  
  258.            <Enter> - Accept line.
  259.  
  260.            <Esc>, <CtrlBreak> - Quit without changing line.
  261.  
  262.            <Left>, <CtrlS> - Cursor left one character.
  263.  
  264.            <Right>, <CtrlD> - Cursor right character.
  265.  
  266.            <CtrlLeft>, <CtrlA> - Cursor left one word.
  267.  
  268.            <CtrlRight>, <CtrlF> - Cursor right one word.
  269.  
  270.            <Home>, <CtrlQ><S> - Cursor to beginning of line.
  271.  
  272.            <End>, <CtrlQ><D> - Cursor to end of line.
  273.  
  274.            <Del>, <CtrlG> - Delete character at cursor.
  275.  
  276.            <Bksp>, <CtrlH>, <CtrlBksp> - Delete character to left of cursor.
  277.  
  278.            <CtrlEnd>, <CtrlQ><Y> - Delete to end of line.
  279.  
  280.            <CtrlY>, <CtrlX> - Delete entire line.
  281.  
  282.            <CtrlHome> - Delete from beginning of line.
  283.  
  284.  
  285.  
  286.  
  287.            <CtrlT> - Delete Word to right of cursor.
  288.  
  289.            <Ins> - Toggle insert mode on and off.  Fat cursor indicates in-
  290.            sert mode; thin cursor indicates overwrite mode.
  291.  
  292.            <CrtlR>, <CtrlQ><L> - Restore original contents of line.
  293.  
  294.            GRAB is provided at no charge to the user.  GRAB is a 'shareware
  295.            type program' without either expressed or implied warranties of
  296.            any kind on an 'as is' basis.  Feel free to share it with your
  297.            friends, but please do not give it away altered or as part of
  298.            another system.  The essence of 'user-supported' software is to
  299.            provide personal computer users with quality software without
  300.            high prices, and yet to provide incentive for programmers to con-
  301.            tinue to develop new products.  If you find this program useful,
  302.            a contribution ($15.00 suggested) would be greatly appreciated.
  303.            Any suggestion or comments you may have are also welcome.
  304.  
  305.            INFORMATION for tested word processors:
  306.  
  307.            WORD PROCESSOR TESTED:             SPECIAL INSTRUCTIONS:
  308.  
  309.            Celebrity                          None Works Fine.
  310.  
  311.            Deskmate (Tandy)                   None Works Fine.
  312.  
  313.            DisplayWrite 4                     Must change marker colors.
  314.  
  315.            * Electric Pencil-PC               Does Not Work.
  316.  
  317.            Farsight (Interface Tech.)         None Works Fine.
  318.  
  319.            Leading Edge Word Processor         Works Fine with the following:
  320.                                               After you have GRAb loaded and
  321.                                               enter the LEWP program hit
  322.                                               <Ctrl> and <Esc> this will
  323.                                               cause a "DOS" to appear in the
  324.                                               upper right hand corner of the
  325.                                               screen indicating that GRAB
  326.                                               and other memory resident
  327.                                               programs may be used.
  328.  
  329.            Letter Perfect                     None Works Fine.
  330.  
  331.            MASS 11 (MEC-Chicago)              None Works Fine.
  332.  
  333.            Microsoft Word (3.1)                1. Word is in TEXT mode.
  334.                                                    (start with --> WORD/C)
  335.  
  336.                                               2. OPTIONS/VISIBLE/NONE
  337.                                                    is selected.
  338.  
  339.            * Multimate (Ashton Tate)          Does Not Work.
  340.  
  341.  
  342.  
  343.  
  344.            * Office Writer (5.0)              None Works Fine.
  345.  
  346.            PC-Write (2.71)                    None Works Fine.
  347.  
  348.            PFS:Professional Write             None Works Fine.
  349.  
  350.            Q&A                                None Works Fine.
  351.  
  352.            Smart System 3.10                  None Works Fine.
  353.  
  354.            Word Perfect 4.2                   None Works Fine.
  355.  
  356.            WordStar                            None Works Fine.
  357.            WordStar 4                          None Works Fine.
  358.            WordStar 2000                       None Works Fine.
  359.  
  360.            * WordVision                        Does Not Work.
  361.  
  362.            * Word Writer PC (Timeworks)       Does Not Work.
  363.  
  364.            XyWrite III Plus                    None Works Fine.
  365.  
  366.            Most of the above reports were made from user's of the older ver-
  367.            sions of GRAB.  If you have different results we would appreciate
  368.            hearing from you.
  369.  
  370.            * If you get one of these Word Processors to work let us know.
  371.            It is possible to use GRAB with a word processor that fails in
  372.            the "text grabbing" mode.  The GRAB utility can be used as an en-
  373.            velope printer by typing in the address with the manual entry
  374.            window.
  375.  
  376.            Please drop us a line if you have had either success or failure
  377.            with a word processor other than any of those listed above.
  378.  
  379.            All contributors will receive a copy of the latest version of the
  380.            GRAB program with a printed illustrated manual.  We will also
  381.            send you an information packet that describes other software
  382.            available from Paul Mayer and ZPAY Payroll Systems.
  383.  
  384.  
  385.                                  ZPAY Payroll Systems
  386.                                    c/of  Paul Mayer
  387.                                    3516 Ruby Street
  388.                                 Franklin Park, IL 60131
  389.  
  390.                                     (312) 671-3130
  391.                   (Please between 7:00 pm and 10:00 pm Chicago time)
  392.  
  393.                                 Compuserve ID 70040,645
  394.  
  395.  
  396.  
  397.  
  398.            GRAB will work on the IBM-PC/XT/AT and true compatible computers
  399.            with PC-DOS or MS-DOS 2.0 or newer.  GRAB should work with most
  400.            popular word processors and printers that use 'text mode' and not
  401.            a 'graphics mode' to display text.
  402.            
  403.  
  404.